package com.maimang.platform.dsp.service;

import com.alibaba.fastjson.JSONObject;
import com.maimang.platform.dsp.entity.AdData;

import java.util.List;


/**
 * @author Rocky
 * @version 1.0.0
 * @classname AdDataService
 * @description <br>广告主数据服务层</br>
 * @date 2019-11-26 11:23:36
 * @email jintaozhao@qq.com
 */
public interface AdDataService {
	/**
	 * 查询广告主数据信息
	 *
	 * @param pkId 广告主数据ID
	 * @return 广告主数据信息
	 */
	AdData selectAdDataById(Integer pkId);

	/**
	 * 查询广告主数据列表
	 *
	 * @param adData 广告主数据信息
	 * @return 广告主数据集合
	 */
	List<AdData> selectAdDataList(AdData adData);

	/**
	 * 新增广告主数据
	 *
	 * @param adData 广告主数据信息
	 * @return 结果
	 */
	int insertAdData(AdData adData);

	/**
	 * 修改广告主数据
	 *
	 * @param adData 广告主数据信息
	 * @return 结果
	 */
	int updateAdData(AdData adData);

	/**
	 * 删除广告主数据信息
	 *
	 * @param ids 需要删除的数据ID
	 * @return 结果
	 */
	int deleteAdDataByIds(String ids);

	/**
	 * 批量同步广告主数据
	 *
	 * @param ids          广告主id列表
	 * @param recentlyDays 最近多少天的数据，最大30
	 * @return
	 */
	int syncAdDataByIds(String ids, int recentlyDays);

	/**
	 * @param advertiserId 代理商广告主id
	 * @param recentlyDays 最近多少天的数据，最大30
	 * @return
	 */
	void syncAdData(Long advertiserId, int recentlyDays);


	/**
	 * 获取广告主基本数据，包括花费、点击量、点击单价等
	 *
	 * @param advertiserId    广告主id
	 * @param startDate       开始日期
	 * @param endDate         结束日期
	 * @param groupBy         分组条件
	 * @param timeGranularity 时间粒度
	 * @param page            页码 默认值: 1,取值范围: ≥ 0
	 * @param pageSize        每页数据量,默认值: 20,取值范围: 1-1000
	 * @param orderField      排序字段
	 * @param orderType       排序类型
	 * @return
	 */
	JSONObject getAdDataList(String advertiserId, String startDate, String endDate, String[] groupBy, String timeGranularity, String orderField, String orderType, int page, int pageSize);

	/**
	 * 同步广告主数据
	 *
	 * @param advertiserId 广告主id
	 * @param startDate    开始日期
	 * @param endDate      结束日期
	 */
	void syncAdData(Long advertiserId, String startDate, String endDate);
}
